home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio / Ham Radio CD-ROM (Emerald Software) (1995).ISO / bbs / bpq402a / appls.doc < prev    next >
Text File  |  1990-02-18  |  3KB  |  80 lines
  1.         Application Support for G8BPQ Switch
  2.  
  3.  
  4. Until now, the switch has supported connects to two sets of application
  5. programs. The first is the BBS, obtained by connecting to the BBS call/alias,
  6. or connecting to the switch end entering BBS. The second is the SYSOP,
  7. obtained by entering the 'C' command without a callsign from the switch. The
  8. commands CONOK ON or HOSTOK ON had to be sent by the program, to indicate 
  9. that the TNC port was available. From Version 3.20, up to 8 applications 
  10. are supported. The first two are as above, the third is reserved for remote 
  11. SYSOP access, and the other 5 are available for your own applications. The
  12. list of application names is given in the APPLICATIONS= param in the config
  13. file, and is a string of up to 8 names of up to 12 chars each, separated by
  14. commas. The names will be listed to the user, along with the normal commands
  15. in the 'available commands' prompt, obtained by entering ?. The user enters
  16. the Application name to connect to it, in the same way as he can enter BBS to
  17. connect to the BBS. Note that, for the moment at least, these additional
  18. applications do not have there own callsign/alias, so must be accessed via 
  19. the switch. (but you could rename the first application if you really want
  20. to!).
  21.  
  22.  
  23. From version 3.55 onwards, applications may use either normal TNC2
  24. mode, or PK232 Hostmode, and it is possible to configure the port so
  25. that the user's command line is passed to the application. You can also
  26. specify whether the user should receive a '*** Connected to APPL' message,
  27. and whether the Application gets a '*** CONNECTED to USER' message. The
  28. TNCPORTLIST has been replaced by sets of params in the following format:
  29.  
  30.  
  31. TNCPORT
  32.     COM=n        ; COMBIOS port number
  33.     TYPE=TNC2 | KISS | PK232/AA4RE | PK232/UFQ
  34.         KISSMASK=nn    ; Required only for KISS. Param is in HEX.
  35.     APPLMASK=nn    ; Defaults to 1 (BBS)
  36.     APPLFLAGS=nn    ; Used for TNC2 and Host Mode. Defaults to 6
  37. ENDPORT
  38. ;
  39.  
  40. APPLMASK is used in the same way as the APPL TNC command described
  41. below. It is really for Host Mode systems, which dont allow the APPL
  42. command, but can be used for others if required. The value is in decimal.
  43.  
  44. APPLFLAGS control whether the user's command is passed to the application,
  45. and also whether 'CONNECTED' messages are sent in each direction. Values
  46. are:
  47.     1 - Send Command to application.
  48.     2 - Send 'Connected' to user.
  49.     4 - Send 'Connected' to application.
  50.  
  51. Values may be combined as required - the default is 6, which gives the
  52. same result as the older versions.
  53.  
  54. There is also an equivalent APPLFLAG command available at TNC2 command level.
  55.  
  56.  
  57.  
  58. When using TNC2 mode, the program should send two commands to the virtual
  59. TNC:-
  60.  
  61.     APPL $NN
  62.  
  63. Where NN has a bit set corresponding to the appl. number. eg $01 for BBS,
  64. $08 for 4th appl. More than one can be set, allowing the port to support 
  65. more than one application. This may be appropriate if the command line is
  66. sent to the application, so it can work out what the user wants.
  67. Note the the default is $01, so existing BBS applications will still work.
  68.  
  69.  
  70.     CONOK ON
  71.  
  72. To indicate port is ready to accept connects.
  73.  
  74.  
  75. See HOSTMODE.DOC for the equivalent Hostmode commands.
  76.  
  77.  
  78. There is a trivial sample application program, SAMPLE.C  on the disk.
  79.  
  80.